std::multimap::emplace

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++0x feature) Atomic operations library (C++0x feature) Thread support library (C++0x feature)
Containers library
array (C++0x feature) vector deque forward_list (C++0x feature) list set multiset map multimap unordered_set (C++0x feature) unordered_multiset (C++0x feature) unordered_map (C++0x feature) unordered_multimap (C++0x feature) stack queue priority_queue
std::multimap
Member functions multimap::multimap multimap::~multimap multimap::operator= multimap::get_allocator Iterators multimap::begin multimap::cbegin (C++0x) multimap::end multimap::cend (C++0x) multimap::rbegin multimap::crbegin (C++0x) multimap::rend multimap::crend (C++0x) Capacity multimap::erase multimap::size multimap::max_size Modifiers multimap::clear multimap::insert multimap::emplace multimap::emplace_hint (C++0x) multimap::erase multimap::swap Lookup multimap::count multimap::find multimap::equal_range multimap::lower_bound multimap::upper_bound Observers multimap::key_comp multimap::value_comp

​template <class... Args> iterator emplace_hint( const_iterator hint, Args&&... args );​		(C++0x)

Inserts a new element to the container, using hint as a suggestion where the element should go. The element is constructed in-place, i.e. no copy or move operations are performed. The constructor of the element type (value_type) is called as follows: the first argument is used to construct the key, the rest of the arguments are used to construct the value.

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

Parameters

hint	-	iterator, used as a suggestion as to where to insert the new element
args	-	arguments to forward to the constructor of the element

Return value

returns an iterator to the inserted element.

Complexity

This section is incomplete

See also

emplace (C++0x)	constructs element in-place (public member function)
insert	inserts elements (public member function)